.TH fmt_fill 3
.SH NAME
fmt_fill \- append spaces to a string
.SH SYNTAX
.B #include <libowfat/fmt.h>

size_t \fBfmt_fill\fP(char *\fIdest\fR,
      size_t \fIsrclen\fR, size_t \fIpadlen\fR,
      size_t \fImaxlen\fR);
.SH DESCRIPTION
fmt_fill appends \fIpadlen\fR-\fIsrclen\fR spaces (if that number is
positive) to \fIdest\fR (which holds \fIsrclen\fR bytes).  It truncates
the output only if the length would exceed \fImaxlen\fR.

It returns the number of bytes it wrote.

fmt_fill does not append \\0.

If \fIdest\fR equals FMT_LEN (i.e. is zero), fmt_fill returns the number
of bytes it would have written.
.SH "SEE ALSO"
fmt_strn(3), fmt_pad(3)
